home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 15 / CU Amiga Magazine's Super CD-ROM 15 (1997)(EMAP Images)(GB)[!][issue 1997-10].iso / CUCD / Graphics / Ghostscript / source / gserver.c < prev    next >
C/C++ Source or Header  |  1996-10-16  |  9KB  |  291 lines
  1. /* Copyright (C) 1992, 1994, 1996 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17. */
  18.  
  19. /* gserver.c */
  20. /* Server front end for Ghostscript, replacing gs.c. */
  21. #include "memory_.h"
  22. #include "string_.h"
  23. #include "ghost.h"
  24. #include "imemory.h"        /* for iutil.h */
  25. #include "interp.h"        /* for gs_interp_reset */
  26. #include "iutil.h"        /* for obj_cvs */
  27. #include "main.h"
  28. #include "ostack.h"
  29. #include "store.h"
  30. #include "gspaint.h"        /* for gs_erasepage */
  31.  
  32. /*
  33.  * This file provides a very simple procedural interface to the Ghostscript
  34.  * PostScript/PDF language interpreter, with a rudimentary provision for
  35.  * saving and restoring state around "jobs".
  36.  * See below for the descriptions of individual procedures.
  37.  *
  38.  * All routines in this file return an integer value which is 0 if the
  39.  * routine completed successfully, non-0 if an error occurred.
  40.  */
  41.  
  42. /* ------ Public interface ------ */
  43.  
  44. /*
  45.  * Initialize Ghostscript.  fno_stdin, fno_stdout, and fno_stderr are
  46.  * file handles that Ghostscript will use in place of stdin, stdout,
  47.  * and stderr respectively.  This routine should be called once at the
  48.  * beginning of execution, and not after that.
  49.  *
  50.  * This routine establishes a "baseline" initial state for Ghostscript,
  51.  * which includes reading in the standard Ghostscript initialization files
  52.  * such as gs_init.ps and gs_fonts.ps.  This baseline is always used as the
  53.  * starting state for gs_server_run_string and gs_server_run_files, unless
  54.  * modified as described below.
  55.  *
  56.  * This routine 'opens' the default driver.
  57.  */
  58.  
  59. int gs_server_initialize(P4(int fno_stdin, int fno_stdout, int fno_stderr,
  60.                 const char *init_str));
  61.  
  62. /*
  63.  * Execute a string containing PostScript code.  The effects of this code
  64.  * do modify the baseline state for future calls of ...run_string and
  65.  * ...run_files.  There are four cases of return values:
  66.  *    value = 0: normal return.
  67.  *    value = e_Quit: the PostScript code executed a `quit'.
  68.  *    value = e_Fatal: the PostScript code encountered a fatal error.
  69.  *        *exit_code_ptr holds the C exit code.
  70.  *    other value: the PostScript code encountered a PostScript error
  71.  *        while processing another error, or some other fatal
  72.  *        PostScript error.
  73.  *
  74.  * errstr points to a string area of length errstr_max_len for reporting
  75.  * the PostScript object causing the error.  In the case of an error return,
  76.  * the characters from errstr[0] through errstr[*errstr_len_ptr-1] will
  77.  * contain a representation of the error object.  *errstr_len_ptr will not
  78.  * exceed errstr_max_len.
  79.  */
  80.  
  81. int gs_server_run_string(P5(const char *str, int *exit_code_ptr,
  82.                 char *errstr, int errstr_max_len,
  83.                 int *errstr_len_ptr));
  84.  
  85. /*
  86.  * Run a sequence of files containing PostScript code.  If permanent is 0,
  87.  * the files do not affect the baseline state; if permanent is 1, they do
  88.  * affect the baseline state, just like ...run_string.  The returned value,
  89.  * exit code, and error string are the same as for gs_server_run_string.
  90.  *
  91.  * If permanent is 0, the output page buffer is cleared before running the
  92.  * first file (equivalent to `erasepage').
  93.  */
  94.  
  95. int gs_server_run_files(P6(const char **file_names, int permanent,
  96.                int *exit_code_ptr, char *errstr,
  97.                int errstr_max_len, int *errstr_len_ptr));
  98.  
  99. /*
  100.  * Terminate Ghostscript.  Ghostscript will release all memory and close
  101.  * all files it has opened, including the ones referenced by fno_stdin,
  102.  * fno_stdout, and fno_stderr.
  103.  *
  104.  * This routine 'closes' the default driver.
  105.  */
  106.  
  107. int gs_server_terminate(P0());
  108.  
  109. /* ------ Example of use ------ */
  110.  
  111. /* To run this example, change the 0 to 1 in the following line. */
  112. #if 0
  113.  
  114. /*
  115.  * This example predefines the name fubar, prints out its value,
  116.  * and then renders the golfer art file supplied with Ghostscript.
  117.  */
  118.  
  119. #include <fcntl.h>
  120. #include <sys/stat.h>
  121. int
  122. main(int argc, char *argv[])
  123. {    int code, exit_code;
  124. #define emax 50
  125.     char errstr[emax+1];
  126.     int errlen;
  127.     static const char *fnames[] = { "golfer.ps", 0 };
  128.     FILE *cin = fopen("stdin.tmp", "w+");
  129.     int sout = open("stdout.tmp", O_WRONLY|O_CREAT|O_TRUNC,
  130.             S_IREAD|S_IWRITE);
  131.     int serr = open("stderr.tmp", O_WRONLY|O_CREAT|O_TRUNC,
  132.             S_IREAD|S_IWRITE);
  133.     code = gs_server_initialize(fileno(cin), sout, serr,
  134.                     "/fubar 42 def");
  135.     fprintf(stdout, "init: code %d\n", code);
  136.     if ( code < 0 ) goto x;
  137.     code = gs_server_run_string("fubar == flush", &exit_code,
  138.                     errstr, emax, &errlen);
  139.     fprintf(stdout, "print: code %d\n", code);
  140.     if ( code < 0 ) goto x;
  141.     code = gs_server_run_files(fnames, 0, &exit_code,
  142.                    errstr, emax, &errlen);
  143.     fprintf(stdout, "golfer: code %d\n", code);
  144.     if ( code < 0 ) goto x;
  145.     errlen = 0;
  146.     code = gs_server_run_string("fubar 0 div", &exit_code,
  147.                     errstr, emax, &errlen);
  148.     errstr[errlen] = 0;
  149.     fprintf(stdout, "0 div: code %d object %s\n", code, errstr);
  150.     errlen = 0;
  151.     code = gs_server_run_string("xxx", &exit_code,
  152.                     errstr, emax, &errlen);
  153.     errstr[errlen] = 0;
  154.     fprintf(stdout, "undef: code %d object %s\n", code, errstr);
  155. x:    code = gs_server_terminate();
  156.     fprintf(stdout, "end: code %d\n", code);
  157.     fflush(stdout);
  158.     close(serr);
  159.     close(sout);
  160.     fclose(cin);
  161.     return code;
  162. }
  163.  
  164. #endif
  165.  
  166. /* ------ Private definitions ------ */
  167.  
  168. /* Forward references */
  169. private int job_begin(P0());
  170. private int job_end(P0());
  171. private void errstr_report(P4(ref *, char *, int, int *));
  172.  
  173. /* ------ Public routines ------ */
  174.  
  175. /* Initialize Ghostscript. */
  176.  
  177. int
  178. gs_server_initialize(int fno_stdin, int fno_stdout, int fno_stderr,
  179.   const char *init_str)
  180. {    int code, exit_code;        /* discard exit_code for now */
  181.     int errstr_len;            /* discard */
  182.     FILE *c_stdin, *c_stdout, *c_stderr;
  183.     /* Establish C-compatible files for stdout and stderr. */
  184.     c_stdin = fdopen(fno_stdin, "r");
  185.     if ( c_stdin == NULL ) return -1;
  186.     c_stdout = fdopen(fno_stdout, "w");
  187.     if ( c_stdout == NULL ) return -1;
  188.     c_stderr = fdopen(fno_stderr, "w");
  189.     if ( c_stderr == NULL ) return -1;
  190.     /* Initialize the Ghostscript interpreter. */
  191.     gs_init0(c_stdin, c_stdout, c_stderr, 0);
  192.     gs_init1();
  193.     gs_init2();
  194.     code = gs_server_run_string("/QUIET true def /NOPAUSE true def",
  195.                     &exit_code,
  196.                     (char *)0, 0, &errstr_len);
  197.     if ( code < 0 ) return code;
  198.     return (init_str == NULL ? 0 :
  199.         gs_server_run_string(init_str, &exit_code,
  200.                      (char *)0, 0, &errstr_len));
  201. }
  202.  
  203. /* Run a string. */
  204.  
  205. int
  206. gs_server_run_string(const char *str, int *exit_code_ptr,
  207.   char *errstr, int errstr_max_len, int *errstr_len_ptr)
  208. {    ref error_object;
  209.     int code;
  210.     make_tasv(&error_object, t_string, 0, 0, bytes, 0);
  211.     code = gs_run_string(str, 0, exit_code_ptr, &error_object);
  212.     if ( code < 0 )
  213.       errstr_report(&error_object, errstr, errstr_max_len,
  214.             errstr_len_ptr);
  215.     return code;
  216. }
  217.  
  218. /* Run files. */
  219.  
  220. int
  221. gs_server_run_files(const char **file_names, int permanent,
  222.   int *exit_code_ptr, char *errstr, int errstr_max_len, int *errstr_len_ptr)
  223. {    int code = 0;
  224.     ref error_object;
  225.     const char **pfn;
  226.     if ( !permanent ) job_begin();
  227.     make_tasv(&error_object, t_string, 0, 0, bytes, 0);
  228.     for ( pfn = file_names; *pfn != NULL && code == 0; pfn++ )
  229.       code = gs_run_file(*pfn, 0, exit_code_ptr, &error_object);
  230.     if ( !permanent ) job_end();
  231.     if ( code < 0 )
  232.       errstr_report(&error_object, errstr, errstr_max_len,
  233.             errstr_len_ptr);
  234.     return code;
  235. }
  236.  
  237. /* Terminate Ghostscript. */
  238.  
  239. int
  240. gs_server_terminate()
  241. {    gs_finit(0, 0);
  242.     return 0;
  243. }
  244.  
  245. /* ------ Private routines ------ */
  246.  
  247. private ref job_save;        /* 'save' object for baseline state */
  248.  
  249. extern int zsave(P1(os_ptr)), zrestore(P1(os_ptr));
  250.  
  251. /* Start a 'job' by restoring the baseline state. */
  252.  
  253. private int
  254. job_begin()
  255. {    int code;
  256.     /* Aladdin Ghostscript doesn't provide erasepage as an operator. */
  257.     /* However, we can get the same effect by calling gs_erasepage. */
  258.     extern gs_state *igs;
  259.     if ( (code = gs_erasepage(igs)) < 0 )
  260.       return code;
  261.     code = zsave(osp);
  262.     if ( code == 0 )
  263.       job_save = *osp--;
  264.     return code;
  265. }
  266.  
  267. /* End a 'job'. */
  268.  
  269. private int
  270. job_end()
  271. {    gs_interp_reset();
  272.     *++osp = job_save;
  273.     return zrestore(osp);
  274. }
  275.  
  276. /* Produce a printable representation of an error object. */
  277.  
  278. private void
  279. errstr_report(ref *perror_object, char *errstr, int errstr_max_len,
  280.   int *errstr_len_ptr)
  281. {    int code = obj_cvs(perror_object, (byte *)errstr,
  282.                (uint)errstr_max_len, (uint *)errstr_len_ptr,
  283.                false);
  284.     if ( code < 0 )
  285.     {    const char *ustr = "[unprintable]";
  286.         int len = min(strlen(ustr), errstr_max_len);
  287.         memcpy(errstr, ustr, len);
  288.         *errstr_len_ptr = len;
  289.     }
  290. }
  291.